================================================================
NOVA PROTECTION v1.0 - README
================================================================

Nova Protection, web sitene ekledigin istemci tarafli bir bot
ve DDoS koruma katmanidir. Ziyaretci siteye girdiginde once bir
dogrulama ekrani gorur, bot olmadigini kanitlarsa siteye gecer.

----------------------------------------------------------------
NASIL CALISIR
----------------------------------------------------------------

1. Ziyaretci siteye girer → Mavi kalkani ekrani cikar
2. "Bot degilim" kutusuna tiklar
3. Sistem 2-3 saniye analiz yapar
   (user-agent, fare hareketi, ekran boyutu, dil, vs.)
4. Güvenliyse → "Siteye Devam Et" butonu cikar
5. Bot ise → Hata mesaji gosterir
6. 30 kez ust üste denerse → 1 saat engellenir

----------------------------------------------------------------
SITEYE NASIL EKLENIR
----------------------------------------------------------------

>> HTML Siteler

</body> kapanis etiketinin hemen üstüne yapistir:

    <script src="Nova_Protection.js"></script>
</body>

Ya da js dosyasi yerine direkt script icerigini kopyalayip
yapistirabilirsin.

---

>> PHP Siteler

footer.php dosyasinin en altina, </body> den once ekle:

    <?php include 'Nova_Protection.js'; ?>

---

>> WordPress

functions.php dosyasina su kodu ekle:

    function nova_koruma_ekle() {
        wp_enqueue_script(
            'nova-protection',
            get_template_directory_uri() . '/Nova_Protection.js',
            array(), '2.0', true
        );
    }
    add_action('wp_enqueue_scripts', 'nova_koruma_ekle');

Sonra Nova_Protection.js dosyasini temanin klasörüne at.

---

>> React / Next.js

_app.js veya layout.js icinde useEffect ile ekle:

    useEffect(() => {
        const script = document.createElement('script');
        script.src = '/Nova_Protection.js';
        document.body.appendChild(script);
    }, []);

Dosyayi public/ klasörüne koy.

----------------------------------------------------------------
DOSYA NEREYE KONULUR
----------------------------------------------------------------

HTML      → index.html ile ayni klasör
WordPress → /wp-content/themes/tema-adin/
React     → /public/
Next.js   → /public/
PHP       → Site kök dizini veya /includes/

----------------------------------------------------------------
ÖNEMLI NOTLAR
----------------------------------------------------------------

- Koruma localStorage tabanlidir. Kullanici localStorage'i
  temizlerse tekrar dogrulama ekrani cikar.

- Bu bir on yüz (frontend) korumasidir, gercek sunucu tarafi
  koruma degildir.

- Biri tarayici konsolundan localStorage.setItem('nvp','1')
  yazarsa dogrulamayi atlayabilir. Guclu guvenlik icin sunucu
  tarafi bir cozumle birlikte kullan.

- 1 saatlik engel de localStorage'a yazilir, kullanici
  temizlerse sifirllanir.

================================================================
Nova Protection v1.0
================================================================
